lsportip

使用 lsportip 命令列出系统中每个节点上的每个以太网端口的配置。该命令显示了因特网协议 (IP) 地址和是否将此端口配置为一个因特网小型计算机系统接口 (iSCSI) 端口。

语法

阅读语法图跳过直观语法图 lsportip -filtervalueattribute=value-filtervalue?-nohdr-delimdelimiterethernet_port_id

参数

-filtervalue attribute=value
指定一个或多个过滤器的列表。仅返回值与过滤器属性值匹配的对象。 如果指定了容量，那么还必须包含单位。
注： 某些过滤器允许您在输入命令时使用通配符。 在 CLI 中使用通配符时，以下规则适用。
  • 通配符为星号 (*)。
  • 命令最多可包含一个通配符，并且该通配符必须是字符串中的第一个或最后一个字符。
  • 使用通配符时，请用双引号 ("") 将过滤器条目括起。
    lsportip -filtervalue "node_name=md*"
-filtervalue?
显示有效过滤器属性。lsporti 命令的以下过滤器属性有效：
  • id
  • node_id
  • node_name
  • state
  • failover
-nohdr
缺省情况下，将在简明样式视图中显示每个数据列的标题，在详细样式视图中显示每个数据项的标题。-nohdr 参数用于禁止显示这些标题。
注： 如果未显示任何数据，那么不会显示标题。
-delim delimiter
缺省情况下，简明视图中的所有数据列都以空格分隔。每列的宽度设置为每个数据项的最大宽度。 在详细视图中，每个数据项各占一行，如果显示标题，将用空格来分隔数据与标题。 -delim 参数会覆盖此行为。 -delim 参数的有效输入为一个单字节字符。 如果在命令行中输入 -delim :，那么在简明视图中将用冒号字符 (:) 分隔所有数据项；例如，不会出现列间距。 在详细视图中，数据与标题间以指定的定界符分隔。
ethernet_port_id
指定以太网端口的标识（1、2、3 或 4）。如果省略该参数，那么将显示所有端口的简明视图。 使用该参数时，将返回指定对象的详细视图，并忽略 -filtervalue 参数指定的任何值。 如果不使用 ethernet_port_id 参数，那么简明视图将显示与 -filtervalue 参数指定的过滤要求相符的所有端口。

描述

此命令可列出 IBM Spectrum Virtualize 系统中每个节点的以太网端口的配置。

使用带有可选 ethernet_port_id 参数的 lsportip 命令可显示指定端口的详细视图。

一个端口的输出行显示可确定的该端口的 MAC 地址。如果节点和以太网链路处于联机状态，那么这两行还会显示此链路的速度和双工状态。 duplex 字段的值可以是 Half 或 Full，或者如果此节点处于脱机状态，那么该字段将为空白。

每个端口的第四行均显示已为该端口配置且未故障转移到其他节点的任何 IP 地址。该行上的 failover 字段设置为 no。每个端口的第二行均显示已为伙伴节点或带有故障转移的本地节点配置的且在该端口上处于活动状态的任何 iSCSI 地址。 该行上的 failover 字段设置为 yes。

如果该端口上未配置任何 iSCSI 地址，那么 state 字段将设置为 unconfigured。如果配置的地址存在但是链路关闭，那么 state 字段设置为 offline，如果链路打开，那么该字段设置为 online。任何脱机行均表明可能有问题。

此命令可显示有关系统端口状态的信息。

下表提供可显示为输出视图数据的属性值。
表 1. lsportip 输出
属性 描述
id 指示以太网端口的标识。
node_id 指示包含端口的节点的标识。
node_name 指示包含端口的节点的名称。
IP address 指示 IPv4 地址（如果无，那么显示为空白）
mask 指示 IPv4 子网掩码（如果无，那么显示为空白）
网关 (gateway) 指示 IPv4 网关（如果无，那么显示为空白）
IP_address_6 指示 IPv6 地址（如果无，那么显示为空白）
prefix_6 指示 IPv6 前缀（如果无，那么显示为空白）
gateway_6 指示 IPv6 网关地址（如果无，那么显示为空白）
MAC 指示当前的 MAC 地址（如果未知，那么显示为空白）。
duplex 指示端口当前的双工状态（如果未知，那么显示为空白）。
state 指示 iSCSI 地址的状态。
  • unconfigured：无 iSCSI 地址（或者硬件可能不存在）。
  • configured：已配置 iSCSI 地址。
  • management_only：对 I/O 操作不可配置。
link_state 指示以太网端口的链路状态。其值为 active 和 inactive。
host 显示用于主机连接的 IPv4 地址。
remote_copy 显示 IPv4 远程拷贝端口组标识。远程拷贝包括高速镜像、全局镜像和 HyperSwap®。
host_6 显示用于主机连接的 IPv6 地址。
remote_copy_6 显示 IPv6 远程拷贝端口组标识。远程拷贝包括高速镜像、全局镜像和 HyperSwap。
remote_copy_status 显示 IPv4 远程拷贝状态。远程拷贝包括高速镜像、全局镜像和 HyperSwap。
remote_copy_status_6 显示 IPv6 远程拷贝状态。远程拷贝包括高速镜像、全局镜像和 HyperSwap。
vlan 显示与该端口上的 IPv4 地址关联的虚拟局域网 (VLAN) 标识（范围 1 到 4094 之间的数字字符）。
vlan_6 显示与该端口上的 IPv6 地址关联的 VLAN 标识（1 到 4094 之间的数字字符）。
adapter_location 显示包含以太网端口的适配器的位置（0 到 8 之间的任何数字）。其中，1 - 8 是 PCIe 扩展槽号，0 表示适配器属于主板一部分或者不在 PCIe 扩展槽中。
adapter_port_id 显示适配器中以太网端口的位置（1 到 4 之间的任何数字）。
dcbx_state 显示端口的 DCBx 状态。
  • unsupported：指示端口不接受交换机端口的优先级流量控制 (PFC) 配置，即使交换机支持 DCBx 也如此。所有 1 Gbps 端口都具有该值。
  • enabled：指示对已连接的交换机端口启用 DCBx，且该端口处于联机状态。
  • disabled：指示对已连接的交换机端口关闭 DCBx，或该端口处于脱机状态。
如果已连接的交换机端口启用了 DCBx，那么在速度为 10 Gb/s 的以太网端口上会自动启用 DCBx。
切记： 该字段被禁用或不受支持时，除 lossless_iscsi 和 lossless_iscsi6 之外的所有其他字段均为空白。
iscsi_priority_tag 显示已连接交换机端口上分配的 iSCSI 协议的数字优先级标记值。该优先级值必须为 0 到 7 之间的数字，或为空白。
fcoe_priority_tag 显示已连接交换机端口上分配的以太网光纤通道 (FCoE) 协议的数字优先级标记值。该值必须为 0 到 7 之间的数字，或为空白。
pfc_enabled_tags 显示在已连接交换机端口上启用 PFC 的优先级标记列表。 如果您希望使用无损 iSCSI 或 FCoE 功能，那么必须为交换机上相应的标记启用 PFC。 在交换机上启用 PFC 后，这些标记会立即显示在该字段中。 该值为空白或以冒号分隔的数字列表（这些数字的范围为 0 到 7）。
要点： 如果交换机上未定义优先级标记，那么该字段为空白。 如果在交换机上定义了优先级标记，但没有为那些优先级标记启用 PFC，那么该字段为空白。
priority_group_0 显示优先级组 0 内的优先级标记的集合。该值为空白或以冒号分隔的数字列表（这些数字的范围为 0 到 7）。该字段是“增强传输选择”(ETS) 设置的一部分。
priority_group_1 显示优先级组 1 内的优先级标记的集合。该值为空白或以冒号分隔的数字列表（这些数字的范围为 0 到 7）。该字段是 ETS 设置的一部分。
priority_group_2 显示优先级组 2 内的优先级标记的集合。该值为空白或以冒号分隔的数字列表（这些数字的范围为 0 到 7）。该字段是 ETS 设置的一部分。
priority_group_3 显示优先级组 3 内的优先级标记的集合。该值为空白或以冒号分隔的数字列表（这些数字的范围为 0 到 7）。该字段是 ETS 设置的一部分。
priority_group_4 显示优先级组 4 内的优先级标记的集合。该值为空白或以冒号分隔的数字列表（这些数字的范围为 0 到 7）。该字段是 ETS 设置的一部分。
priority_group_5 显示优先级组 5 内的优先级标记的集合。该值为空白或以冒号分隔的数字列表（这些数字的范围为 0 到 7）。该字段是 ETS 设置的一部分。
priority_group_6 显示优先级组 6 内的优先级标记的集合。该值为空白或以冒号分隔的数字列表（这些数字的范围为 0 到 7）。该字段是 ETS 设置的一部分。
priority_group_7 显示优先级组 7 内的优先级标记的集合。该值为空白或以冒号分隔的数字列表（这些数字的范围为 0 到 7）。该字段是 ETS 设置的一部分。
bandwidth_allocation 显示为优先级组 0 到 7 保证的带宽分配百分比列表。该值为空白或各优先级组的带宽分配百分比的逗号分隔数字列表（其中，每个百分比都是整数）。该字段是 ETS 设置的一部分。
注： 如果还没有为网络上的任何优先级组分配特定带宽，那么该字段为空白。
lossless_iscsi 显示针对 iSCSI 因特网协议 V4 (IPv4) IP 地址启用 (on) 还是禁用 (off) PFC。 要开启 PFC，必须满足以下条件。
  • 端口为具有有效 IPv4 地址的 10 Gbps 端口。
  • 对交换机端口启用了适用于 iSCSI 的 PFC。
  • 将虚拟局域网 (VLAN) 配置为使用该 IPv4 地址。
  • 对端口启用了 iSCSI 主机连接。
否则值为 off。
lossless_iscsi6 显示针对 iSCSI 因特网协议 V6 (IPv6) IP 地址启用 (on) 还是禁用 (off) PFC。 要开启 PFC，必须满足以下条件。
  • 端口为具有有效 IPv6 地址的 10 Gbps 端口
  • 对交换机端口启用了适用于 iSCSI 的 PFC
  • 将虚拟局域网 (VLAN) 配置为使用该 IPv6 地址
  • 对端口启用了 iSCSI 主机连接
否则值为 off。
storage 指示是否将 IPv4 地址用于 iSCSI 后端存储连接功能。值为 yes 和 no（缺省值）。 如果未指定任何地址，那么该值为空。
storage_6 指示是否将端口上的 IPv6 地址用于 iSCSI 后端存储连接功能。 值为 yes 和 no（缺省值）。如果未指定任何地址，那么该值为空。
host_port_grp_id 在简明和详细视图中均指示主机端口组标识。 值包括 0 和 1 - 32。

对于任何以太网端口，缺省值为 0。

已配置的所有主机连接端口都具有非零 host_port_grp_id。

  • 0（缺省值）：对于新安装，主机标志设置为“no”的所有已配置 iSCSI 端口都会将此字段设置为 0。

    从较低版本进行更新时，会将之前配置的所有 iSCSI 端口添加到缺省主机端口组（即 0）中。更新到最新版本后，即使主机标志设置为“yes”，也会将 iSCSI 端口放置在主机端口组 0 中。

  • 1 - 32：这些主机端口组标识将分配给主机标志设置为“yes”的每个已配置的 iSCSI 端口。

    主机端口分组会将具有相同速度且具有相同 rdma_type 功能的端口分组在一起。具有相同速度但具有不同 rdma_type 功能的端口将单独分组。

    例如，速度为 25 Gbps 且 rdma_type 为 iWARP 的端口与速度为 25 Gbps 且 rdma_type 为 RoCE 的端口分在不同组中。

    主机端口分组可确保恢复期间主机发现的端口不超过 4 个。每个系统节点最多有 4 个端口可属于同一个主机端口组标识。 属于同一主机端口组标识的所有端口具有相同的速度和相同的 rdma_type 功能。在 I/O 组的两个节点中，最多 8 个 iSCSI 端口（每个节点 4 个）可以属于同一主机端口组标识。

在以下示例（其中列出不同的端口配置选项）中，每个可能的以太网端口都存在两行。这两行表示端口和 iSCSI 行为效果。将静态分配端口索引。较大的索引用于可选端口。

简明调用示例

lsportip -delim ,

生成的输出

id,node_id,node_name,IP_address,mask,gateway,IP_address_6,prefix_6,gateway_6,MAC,duplex,state,speed,failover,
link_state,host,remote_copy,host_6,remote_copy_6,remote_copy_status,remote_copy_status_6,vlan,vlan_6,
adapter_location,adapter_port_id,lossless_iscsi,lossless_iscsi6,storage,storage_6,host_port_grp_id,
1,1,node1,192.168.48.135,255.255.255.0,192.168.48.1,,,,5c:f3:fc:f5:67:ca,Full,configured,1Gb/s,no,
active,yes,1,,0,unused,,65,,0,1,off,,no,1,
1,1,node1,,,,,,,5c:f3:fc:f5:67:ca,Full,configured,1Gb/s,yes,active,,0,,0,,,,,0,1,,,,0
2,1,node1,192.168.48.136,255.255.255.0,192.168.48.1,,,,5c:f3:fc:f5:67:cb,Full,configured,1Gb/s,no,
active,yes,1,,0,unused,,,,0,2,off,,no,1
2,1,node1,,,,,,,5c:f3:fc:f5:67:cb,Full,configured,1Gb/s,yes,active,,0,,0,,,,,0,2,,,,0
3,1,node1,192.168.48.137,255.255.255.0,192.168.48.1,,,,00:90:fa:27:ec:22,,configured,10Gb/s,no,
active,yes,1,,0,unused,,,,1,1,off,,no,1
3,1,node1,,,,,,,00:90:fa:27:ec:22,,configured,10Gb/s,yes,active,,0,,0,,,,,1,1,,,,0
4,1,node1,192.168.48.138,255.255.255.0,192.168.48.1,0009:2009:0003:0004:0005:0006:0007:1130,64,
fe80:0000:0000:0000:0007:b4ff:fe00:0a00,00:90:fa:27:ec:24,,configured,10Gb/s,no,
active,yes,1,yes,0,unused,,165,170,1,2,on,on,yes,yes,1
4,1,node1,,,,,,,00:90:fa:27:ec:24,,configured,10Gb/s,yes,active,,0,,0,,,,,1,2,,,,0
1,2,node2,192.168.48.145,255.255.255.0,192.168.48.1,,,,5c:f3:fc:f5:68:b2,Full,configured,1Gb/s,no,
active,yes,1,,0,unused,,65,,0,1,off,,no,1
1,2,node2,,,,,,,5c:f3:fc:f5:68:b2,Full,configured,1Gb/s,yes,active,,0,,0,,,,,0,1,,,,0
2,2,node2,192.168.48.146,255.255.255.0,192.168.48.1,,,,5c:f3:fc:f5:68:b3,Full,configured,1Gb/s,no,
active,yes,1,,0,unused,,,,0,2,off,,,1
2,2,node2,,,,,,,5c:f3:fc:f5:68:b3,Full,configured,1Gb/s,yes,active,,0,,0,,,,,0,2,,,,0
3,2,node2,192.168.48.147,255.255.255.0,192.168.48.1,,,,00:90:fa:27:ec:4a,,configured,10Gb/s,no,
active,yes,1,,0,unused,,,,1,1,off,,no,1
3,2,node2,,,,,,,00:90:fa:27:ec:4a,,configured,10Gb/s,yes,inactive,,0,,0,,,,,1,1,,0
4,2,node2,192.168.48.148,255.255.255.0,192.168.48.1,0009:2009:0003:0004:0005:0006:0007:1230,64,
fe80:0000:0000:0000:0007:b4ff:fe00:0a00,00:90:fa:27:ec:4c,,configured,10Gb/s,no,active,yes,1,yes,
0,unused,,165,170,1,2,on,on,yes,yes,1
4,2,node2,,,,,,,00:90:fa:27:ec:4c,,configured,,yes,inactive,,0,,0,,,,,1,2,,,,0

简明调用示例

lsportip

生成的输出


id node_id node_name IP_address   mask          gateway     IP_address_6                            prefix_6 gateway_6                               MAC               duplex state      speed failover link_state host remote_copy host_6 remote_copy_6 remote_copy_status remote_copy_status_6 vlan vlan_6 adapter_location adapter_port_id lossless_iscsi lossless_iscsi6 storage storage_6 host_port_grp_id 
1  1       node1     192.168.1.52 255.255.255.0 192.168.1.1                                                                                          5c:f3:fc:0b:da:64 Full   configured 1Gb/s no       active     yes  0                  0                                                                 0                1               off                            yes               1       
1  1       node1                                                                                                                                     5c:f3:fc:0b:da:64 Full   configured 1Gb/s yes      active          0                  0                                                                 0                1                                                                0 
2  1       node1                                            fc00:0000:0000:0000:445a:0a17:fcf7:0236 64       fc00:0000:0000:0000:445a:0a17:fcf7:0001 5c:f3:fc:0b:da:66 Full   configured 1Gb/s no       active          0           yes    0                                                                 0                2                              off                     yes       1 
2  1       node1                                                                                                                                     5c:f3:fc:0b:da:66 Full   configured 1Gb/s yes      active          0                  0                                                                 0                2                                                                0
1  2       node2     192.168.1.53 255.255.255.0 192.168.1.1                                                                                          e4:1f:13:2f:b4:a4 Full   configured 1Gb/s no       active     yes  0                  0                                                                 0                1               off                            no                1
1  2       node2                                                                                                                                     e4:1f:13:2f:b4:a4 Full   configured 1Gb/s yes      active          0                  0                                                                 0                1                                                                0
2  2       node2                                            fc00:0000:0000:0000:445a:0a17:fcf7:0237 64       fc00:0000:0000:0000:445a:0a17:fcf7:0001 e4:1f:13:2f:b4:a6 Full   configured 1Gb/s no       active          0           yes    0                                                                 0                2                              off                     no        1
2  2       node2                                                                                                                                     e4:1f:13:2f:b4:a6 Full   configured 1Gb/s yes      active          0                  0                                                                 0                2                                                                0

详细调用示例

lsportip 1

生成的详细输出：

id 1
node_id 1
node_name node1
IP_address 192.168.20.10
mask 255.255.255.0
gateway 192.168.20.1
IP_address_6
prefix_6
gateway_6
MAC 00:1a:64:97:1b:a0
duplex Full
state online
speed 1Gb/s
failover no
mtu 1500
host yes
remote_copy 0
host_6
remote_copy_6 0
remote_copy_status
remote_copy_status_6
vlan 1063
vlan_6
adapter_location 1
adapter_port_id 1
dcbx_state Enabled
iscsi_priority_tag  4  
fcoe_priority_tag  3 
pfc_enabled_tags 3:4 
pfc_disabled_tags  0:1:2:5:6:7 
priority_group_0  
priority_group_1  
priority_group_2  
priority_group_3  
priority_group_4  
priority_group_5  
priority_group_6 3
priority_group_7 4
bandwidth_allocation 0:0:0:0:0:0:30:30
lossless_iscsi  on 
lossless_iscsi6 
storage yes
storage_6
host_port_grp_id 1


id 1
node_id 1
node_name node1
IP_address
mask
gateway
IP_address_6
prefix_6
gateway_6
MAC 00:1a:64:97:1b:a0
duplex Full
state online
speed 1Gb/s
failover yes
mtu 1500
host yes
remote_copy 0
host_6
remote_copy_6 0
remote_copy_status
remote_copy_status_6
vlan 1063
vlan_6
adapter_location 1
adapter_port_id 1
dcbx_state Enabled
iscsi_priority_tag  4  
fcoe_priority_tag  3 
pfc_enabled_tags 3:4 
pfc_disabled_tags  0:1:2:5:6:7 
priority_group_0  
priority_group_1  
priority_group_2  
priority_group_3  
priority_group_4  
priority_group_5  
priority_group_6 3
priority_group_7 4
bandwidth_allocation 0:0:0:0:0:0:30:30
lossless_iscsi  on 
lossless_iscsi6 
storage
storage_6
host_port_grp_id 1


id 1
node_id 2
node_name node2
IP_address 192.168.20.11
mask 255.255.255.0
gateway 192.168.20.1
IP_address_6
prefix_6
gateway_6
MAC 00:1a:64:97:16:08
duplex Full
state online
speed 1Gb/s
failover no
mtu 1500
host yes
remote_copy 0
host_6
remote_copy_6 0
remote_copy_status
remote_copy_status_6
vlan 1063
vlan_6
adapter_location 1
adapter_port_id 1
dcbx_state Enabled
iscsi_priority_tag  4  
fcoe_priority_tag  3 
pfc_enabled_tags 3:4 
pfc_disabled_tags  0:1:2:5:6:7 
priority_group_0  
priority_group_1  
priority_group_2  
priority_group_3  
priority_group_4  
priority_group_5  
priority_group_6 3
priority_group_7 4
bandwidth_allocation 0:0:0:0:0:0:30:30
lossless_iscsi  on 
lossless_iscsi6 
storage yes
storage_6
host_port_grp_id 1


id 1
node_id 2
node_name node2
IP_address
mask
gateway
IP_address_6
prefix_6
gateway_6
MAC 00:1a:64:97:16:08
duplex Full
state online
speed 1Gb/s
failover yes
mtu 1500
host yes
remote_copy 0
host_6
remote_copy_6 0
remote_copy_status
remote_copy_status_6
vlan 1063
vlan_6
adapter_location 1
adapter_port_id 1
dcbx_state Enabled
iscsi_priority_tag  4  
fcoe_priority_tag  3 
pfc_enabled_tags 3:4 
pfc_disabled_tags  0:1:2:5:6:7 
priority_group_0  
priority_group_1  
priority_group_2  
priority_group_3  
priority_group_4  
priority_group_5  
priority_group_6 3
priority_group_7 4
bandwidth_allocation 0:0:0:0:0:0:30:30
lossless_iscsi  on 
lossless_iscsi6 
storage
storage_6
host_port_grp_id 1